home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / cb101a.zip / CALLBACK.DOC < prev    next >
Text File  |  1992-11-12  |  15KB  |  322 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6. Eric's CallBack Verification System for RBBS-PC
  7. CallBack v1.01 (alpha) 11/10/92
  8. Previous Release: Callback 1.19b (beta), 10/25/92. (in Clipper)
  9. Copyright (c)1991,1992 Eric Givler, All Rights Reserved.
  10.  
  11. TABLE OF CONTENTS:
  12.  
  13.   Features . . . . . . . . . . . . . . . . . . . . . . . . .1
  14.   History. . . . . . . . . . . . . . . . . . . . . . . . . .1
  15.   Disclaimer . . . . . . . . . . . . . . . . . . . . . . . .2
  16.   What You Should Have Received. . . . . . . . . . . . . . .3
  17.   Configuring. . . . . . . . . . . . . . . . . . . . . . . .3
  18.   Execution. . . . . . . . . . . . . . . . . . . . . . . . .4
  19.   Logfile Error Messages . . . . . . . . . . . . . . . . . .4
  20.   Upgrading From Previous Version. . . . . . . . . . . . . .5
  21.   Memory Used. . . . . . . . . . . . . . . . . . . . . . . .5
  22.   Registration And Other Information . . . . . . . . . . . .5
  23.  
  24.  
  25. FEATURES:
  26.  
  27.    o Easily configured by just entering the name CALLBACK at DOS.
  28.    o Uses industry standard Hayes modem commands for dialing. (ATDT,ATDP)
  29.    o Configurable to stay on-line after local callbacks.
  30.    o Configurable for Tone or Pulse dialing.
  31.    o Configurable option to perform long distance callbacks.
  32.    o Configurable locked baud rate (up to 38400) or use Dorinfo baud rate.
  33.    o Easily edit your local dialing area (area code and prefixes).
  34.    o Allows you to set level that users must have to access this program.
  35.    o Allows you to set level for validated users.
  36.    o Configurable to allow this program to reside in other directory.
  37.    o Easily edit the instruction screen (CALLBACK.TXT)
  38.    o Supports local and long distance dialing prefixes.  (up to 6 numbers
  39.      each).  For ld calls, the prefix would appear in the dial string
  40.      before the 1, ie.  "917175618150"  "9" would be the prefix.
  41.    o Configurable to not call numbers that already have validated users
  42.      for them.
  43.    o Configurable to limit # of calls (bad attempts) to a phone number.
  44.    o RBBS-PC USERS file need not be named USERS.
  45.  
  46.  
  47. HISTORY:
  48.  
  49. v1.00   Fed up without having a callback verifier, I wrote CALLBACK v1.00.
  50.         I know, PCBVERIFY existed, but it was written for PCBoard and required
  51.         an additional program: RBBSPCBV, both of which required REGISTRATION.
  52.         Besides, I can write my own software!  This version had NO 
  53.         configuration capability and was tailored to work for me only, and it 
  54.         did.  Approximate programming time was about 2 hours.  Over the next
  55.         several weeks, enhancement continued and I pondered additional
  56.         features until...
  57.  
  58. v1.10   The configurable version of CALLBACK was introduced.  Configuration
  59.         information was stored in a dBASE .MEM file and read during startup.
  60.  
  61. v1.11   This version allows you to specify whether the system should stay
  62.         on-line on local callbacks.  The configuration is available via
  63.         Setup. (starting CALLBACK without any command line switches)
  64.  
  65.                                           1
  66.  
  67.  
  68.  
  69.  
  70. v1.12   Minor *bug* fixes and cleaned up this documentation.  No longer
  71.         date stamped (ie. Not Crippleware).
  72.  
  73. v1.13   Added support for local and long distance dialing prefixes.
  74.         Program displays the DORINFO filename it is trying to read, along
  75.         with the com port being accessed.  Revised documentation adding
  76.         section describing what happens during execution.  Added "DUMP"
  77.         option so sysop can dump the logfile to a text file: logfile.txt
  78.         in case sysop does not have dBASE access.  Rewrote ALL input
  79.         routines so sysop can enter characters too (I used this for test
  80.         purposes, but this will make the transition to C/pascal EASIER.)
  81.  
  82. v1.14   Internal version.  Only small documentation changes and clean-up
  83.         of code for easier readability.  No code modifications.  Never
  84.         released for general distribution.
  85.  
  86. v1.15   Added support to not callback #s that have been validated before.
  87.         Added support to limit # of calls to a certain phone number.
  88.  
  89. v1.16   Removed usage of DORINFO.DBF.  Done as first step to ensure it
  90.         would work on multi-node systems.  Callback now reads this using
  91.         low-level file i/o on a line-by-line basis.
  92.  
  93. v1.17   Changed RBBS default dir option to be RBBS USERS DIR & FILE.
  94.         The program was only working with rbbs-pc users files named
  95.         USERS.  For example: C:\RBBS-PC\MAINU.DEF.  As a note, the program
  96.         would then expect to find your DORINFO file in C:\RBBS-PC.
  97.         
  98. v0.01a  Rewritten in Turbo Pascal v6.0.  FOSSIL required!
  99.         DUMP option removed.  The log information is stored in LOGFILE.DBF
  100.         as before.  You must have a utility to read this dBASE file.
  101.  
  102. v1.01a  Added support for RBBS-PC Hashing routine to find user quickly.
  103.         Time string in logfile now set to 24 hour military time.
  104.         Fixed glitches with Callback:
  105.         o Didn't close comport on certain errors.
  106.         o Fixed logfile dump - it would not show the first record.
  107.         o Exited with errorlevels other than 0 which may have screwed up rbbs?
  108.         o Couldn't get to first character to edit phone number input.
  109.         o Would NOT validate a user if he was the 1st record in the user file!
  110.         o Ability to ZAP (remove) all the records from the logfile.dbf added.
  111.         o Ability to Remove all records except those marked 'Validated' added.
  112.         o Added message to tell user why he was kicked out of door if security
  113.           was not ok.
  114.         o Tell callback to not call verified #'s and it still calls them!
  115.           (configuration set to NO).  FIXED.
  116.         o Stay online on locals set to No, and it still stays online: FIXED.
  117.         o 3 digit prefixes could be found in other area codes and determined
  118.           as local to the current areacode.
  119.  
  120. DISCLAIMER:
  121.  
  122.    This software is  guaranteed to  work on my  system  and *hopefully*
  123.    on yours.  Otherwise,  the author  specifically disclaims  all other
  124.    warranties, expressed  or  implied,  including  but not  limited  to
  125.    implied warranties of merchantability and fitness for  a  particular
  126.    purpose  and  theprogram  license granted herein  in particular, and
  127.    without limiting operation  of the program  license with  respect to
  128.  
  129.                                           2
  130.  
  131.  
  132.  
  133.  
  134.    any particular application, use, or purpose.  IN NO EVENT SHALL  THE
  135.    AUTHOR  BE LIABLE  FOR ANY LOSS OF  PROFIT, LOST SAVINGS, COMMERCIAL
  136.    DAMAGE, OR OTHER  INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
  137.    THE USE OR  INABILITY TO  USE  CALLBACK  EVEN IF THE  AUTHOR Eric J.
  138.    Givler HAS BEEN ADVISED  OF THE  POSSIBILITY OF SUCH DAMAGES, OR FOR
  139.    ANY CLAIM BY ANY OTHER PARTY.
  140.  
  141.  
  142. WHAT YOU SHOULD HAVE RECEIVED:
  143.  
  144. CALLBACK.EXE - Main EXEcutable
  145. [CALLBACK.CFG - created during execution with no command-line parameters]
  146. CALLBACK.DOC - This file.
  147. CALLBACK.TXT - Initial entry screen (user editable).
  148. CALLME.BAT   - The RBBS batch file called via DOORS. (Sample Only)
  149. CONFIG.DBF   - Used during full-screen Configuration data entry.
  150. DORINFO1.DEF - A sample RBBS-PC DORINFO.DEF file
  151. LOGFILE.DBF  - Logs callback status
  152. [LOGFILE.NDX - created during program execution for quick-lookups.]
  153. PREFIX.TXT   - Sample PREFIX file.  CallBack reads this to determine whether
  154.                a call is long distance.
  155. FILELIST.TXT - The files in the distribution archive.
  156.  
  157.  
  158. CONFIGURING:
  159.  
  160. Run the program without any command line parameters.  Follow the on
  161. screen directions.  These are the defaults from the distribution version
  162. for the configuration of the callback program.
  163.  
  164.  1) Does not allow callbacks to "Validated" phone numbers.
  165.  2) Only call a number 3 times before no longer attempting.
  166.     NOTE: OverRidden by option to not call validated numbers (if set).
  167.  3) Blank local dialing prefix.
  168.  4) Blank long distance dialing prefix.
  169.  5) Use tone (ATDT) instead of pulse (ATDP)
  170.  6) Do not validate users if they are long distance.
  171.  7) Stay online after a local callback success.
  172.  8) Once validated users are upgraded to level 4.
  173.  9) My local areacode is 717.
  174. 10) Locked baud rate of 19200.
  175. 11) Newuser security level is 3.
  176. 12) Default RBBS-PC User file and directory is C:\RBBS-PC\USERS
  177.     This is where your users file and dorinfo file should reside.  
  178.  
  179. PREFIX.TXT is a list of your local prefixes.  You should edit this file to 
  180. reflect your local calling area.  Each line entry should be either 3 or 6
  181. characters ending with a carriage return/line feed.  (6 character lines
  182. are for local numbers in other areacodes.  Areacodes are required on every
  183. line that is not in your areacode if it is still local).
  184.  
  185. The "Dump"  option allows you to create a text file of the contents of
  186. the LOGFILE.DBF.  This was written for NON-dBase users.  It also allows
  187. you to see what problems are being encountered during program execution.
  188.  
  189. The "R" option - Remove failed callback information will delete any
  190. records in your LOGFILE.DBF that did not result in a Validation.  The
  191. database is then packed to save space.
  192.  
  193.                                           3
  194.  
  195.  
  196.  
  197.  
  198. The "Z" option - The ZAP option removes all the records in the LOGFILE.DBF.
  199.  
  200. A sample CALLME.BAT file which could be invoked via the doors is enclosed.
  201. I do NOT include the watchcd program which is usually included with rbbs-pc
  202. or your fossil driver.
  203.  
  204.  
  205. EXECUTION:
  206.  
  207. When this program is being executed (the user exited to this door), you
  208. should see a screen that looks like:
  209.      ERIC'S RBBS-PC PASCAL Callback Verifier v0.01a
  210.      Reading C:\RBBS-PC\DORINFO1.DEF   (possibly different)
  211.      FOSSIL: Ray Gwinn's double aught ... (possibly different)
  212.      Port  : COM<comport>
  213.      Baud  : <baudrate>
  214.      Parity: <parity>           (FOSSIL mask for this parity           )
  215.      Word  : <data bits>        (FOSSIL mask for the number of databits)
  216.      Stop  : <stop bits>        (FOSSIL mask for the number of stopbits)
  217.      First : <user firstname>
  218.      Last  : <user lastname>
  219.      Seclev: <user security level>
  220.      Passwd: <user password>
  221.      Rec#  : <user record number in USERS file>
  222.  
  223. Then the message screen (callback.txt) will be displayed and the user
  224. will be asked to enter the phone number.  If this is not displayed on your
  225. screen:
  226.  
  227.    o Your batch file was not written correctly.  Remember to include the %1
  228.      in the batch file.  CALLBACK will use this 'node number' to look in your
  229.      RBBS-PC default directory to find a DORINFO#.DEF file to read.
  230.    o You misconfigured the callback program.
  231.    o You are running in local mode with the modem turned off.  WHY?
  232.    o You have a NON-standard com port/IRQ setup.
  233.    o Some other error occurred that you(we) must troubleshoot.
  234.  
  235. ie. In your batch file, it should read: CALLBACK %1
  236.  
  237.  
  238. LOGFILE ERROR MESSAGES:
  239.  
  240. CALLBACK.CFG missing!   The callback configuration file: CALLBACK.CFG
  241.                         was missing.  The program does not check for a
  242.                         missing CONFIG.DBF.
  243. DORINFO?.DEF error!     Could not find dorinfo?.def file in rbbs directory.
  244. Security <> #           User's security is not equal to the proper security
  245.                         to use the door (ie. newuser access level)
  246. Userfile open ERROR!    Could not open the RBBS user file in the rbbs path or
  247.                         you misnamed your users file in the configuration.
  248. Not in USERS            The user executing this door is not in the USERS
  249.                         file (not possible?)
  250. Incompatible FOSSIL     Your FOSSIL driver is not revision 5 or later.
  251. Failed port open        Could not open the comm port determined from the
  252.                         dorinfo file.
  253. LD call!                Logged if ld support is disallowed and user is not
  254.                         in your local calling exchange or is in another
  255.                         area code.
  256.  
  257.                                           4
  258.  
  259.  
  260.  
  261.  
  262. Invalid phone           Invalid phone number entered - the phone number is
  263.                         not 7 or 10 digits after stripping all numeric
  264.                         characters and before adding dialing prefixes.
  265. # Already validated     This phone number was already validated and you
  266.                         configured the system to NOT call numbers that are
  267.                         already validated.
  268. Too many bad calls      This message is set if the system detects too many
  269.                         bad calls to a number and you have configured the
  270.                         system to limit the number of attempts to a number.
  271. Didn't proceed: x       Displays character user entered to request to proceed
  272.                         if it is NOT y or Y.
  273. Hangup failed           Could not hang up the modem after user selected to
  274.                         proceed with callback.  Tries to hangup by dropping
  275.                         DTR for 1 second.
  276. Callback Timeout        Callback failed to connect in 1 minute after
  277.                         calling the user back.  (no carrier)  It only tries
  278.                         to callback one time and does not check for incoming
  279.                         rings.
  280. Validated               User was validated and his security was raised.
  281. Pword: XXXXXXXX         User did not enter correct password on all three
  282.                         attempts.  This is his latest attempt.
  283.  
  284.  
  285. UPGRADING FROM PREVIOUS VERSION:
  286.  
  287. If you were using a previous version of callback, all you will need to
  288. use this latest version is to copy the CALLBACK.EXE from the distribution 
  289. archive to the directory that you run callback again.  *** MAKE SURE TO DO 
  290. A SCREEN DUMP OF YOUR PREVIOUS CONFIGURATION OPTIONS AS THIS VERSION USES
  291. A NEW SETUP SYSTEM ***  This may seem like a nuisance, but it is so quick
  292. and easy to configure, that I did it this way.  It also saves code space
  293. as I didn't want to write conversion routines for reading a dBASE .MEM file
  294. in Pascal.  This currently does not apply to upgrading between the Pascal
  295. versions released thus far.
  296.  
  297.  
  298. MEMORY USED:
  299.  
  300. Not sure.
  301.  
  302.  
  303. REGISTRATION AND OTHER INFORMATION:
  304.  
  305. If you have any complaints or problems, please notify me as soon as you can.
  306. This code could be easily modified to run on a networked RBBS system or
  307. support Desqview detection.  Comments and suggestions should be mailed to me.
  308.  
  309. If you like the idea of a callback verifier for RBBS, send a small token
  310. of your appreciation ($15 suggested but anything welcome) to the address
  311. below, and we will ship you the newest version [if one exists] on the
  312. media of your choice.  Future upgrades can be obtained by simply writing
  313. me.
  314.  
  315. Eric J. Givler
  316. 133-A Herman Avenue
  317. Lemoyne, Pa  17043
  318. Voice: (717) 763-2055
  319.  
  320.  
  321.                                           5
  322.